home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / arc / DMS_Face.readme < prev    next >
Encoding:
Text File  |  1995-04-27  |  13.5 KB  |  322 lines
  1. Short:    Excellent MagicWB GUI front-end for DMS
  2. Author:   Pat Seguin
  3. Uploader: golly@dircon.co.uk
  4. Type:     util/arc
  5.  
  6.                   DMS-Face by Pat Seguin, Copyright 1994
  7.                       Version 1.1 - February 25, 1994
  8.  
  9. Welcome to DMS-Face v1.1, the ultimate DiskMasher interface!  Alot of work has
  10. gone into making this program a GUI-lover's dream!  No longer do you have to
  11. type long lines of commands to decompress, compress, view, or test your DMS
  12. archives.  Everything can be achieved with the mouse.
  13.  
  14. I crashed my hard drive a while back and lost some of my most useful utilities
  15. which included a DMS GUI.  I had the resources to make my own interface to do
  16. the work for me so I decided to take on this project. I decided that the usual
  17. 4-color interfaces for many Amiga utilities were kind of boring so I decided to
  18. use the MagicWB XEN style and colors.  Because of the wide exceptance of
  19. MagicWB, I felt that leaving this program's GUI as is would be exceptable to
  20. most users.  If there is a call for it, I will release another version with a
  21. standard 4-color interface.
  22.  
  23. Features of DMS-Face:
  24. --------------------
  25.  
  26. * Enhanced 8-color custom GUI using the popular MagicWB XEN style.
  27.  
  28. * Full support for all command-line arguments of DMS.
  29.  
  30. * Preferences editor for defining DMS command and default directories.
  31.  
  32. * Full GUI for every DMS function; Write, Read, Test, View
  33.  
  34. Requirements for DMS-Face:
  35. -------------------------
  36.  
  37. * OS 2.04 or better (designed under OS 3.0)
  38.  
  39. * An Amiga with 1MB of RAM
  40.  
  41. * Workbench running at least 3 bitplanes (8 colors) with MagicWB palette
  42.   scheme (supplied in archive).  NOTE:  Will work with less than 3 bit-
  43.   planes but will be hard to read.
  44.  
  45. * DMS v1.11
  46.  
  47. Installation:
  48. ------------
  49.  
  50. 1.) 'Antique' font is no longer needed as in v1.0.  You do however need to have
  51.     XHelvetica and XEN fonts that were supplied with MagicWB.  These are NOT
  52.     included in this archive.
  53. 2.) Copy DMS-Face anywhere you like.
  54.  
  55. That's it!  The program will use it's internal defaults until you change the
  56. settings in the prefrences editor.  See PREFERENCES for more information.
  57.  
  58. The Program:
  59. -----------
  60.  
  61. Double-click the DMS-Face icon and you will be presented with the (pain-in-
  62. the-butt) DeckRunner delay window and then the DMS-Face window in WRITE mode.
  63.  
  64. If you have never used DMS-Face before, then the internal defaults will be used
  65. to locate DMS, and for all of the default directories.  You should go right to
  66. the preferences editor before using DMS-Face and define your paths.  See the
  67. PREFERENCES section.
  68.  
  69. Note: When you first start the program, or if there is no filename selected,
  70. certain buttons and gadgets in every mode will be 'ghosted' or unavailable.
  71. You must select a DMS file before you can change any options or click 'Start'.
  72.  
  73. Also Note: DMS-Face 1.0 had editable text-string fields for filenames.  DMS-
  74. Face 1.1 does NOT.  I wanted to use only XHelvetica font and CanDo does not
  75. support proportional fonts in string gadgets. I can justify this by saying
  76. that if you want to type, use DMS from CLI!
  77.  
  78. WRITE MODE
  79. ----------
  80.  
  81. The SOURCE field is where the name of the file you wish to decompress should go.
  82. Youuse the popfile gadget to the left of the text field to get the name.
  83. You will be presented with an ASL file requester asking for the filename and
  84. only filenames ending with '.DMS' will be shown.
  85.  
  86. NOTE: The source field only displays the filename you are working with.  If you
  87. want to see the full filename with the path, double-click on the filename and
  88. a window will open giving you pertitnent information.
  89.  
  90. The OPTIONS area corresponds to the available options for DMS in WRITE mode.
  91. Please read your DMS documentation for more information on these options.
  92. When the option is active, there will be a checkmark displayed next to it.
  93.  
  94. The DEST area displays the device where the file will be decompressed to.
  95. The gadget is a popup gadget, not a popfile gadget.  This means that when you
  96. click on it, a list will pop up giving you four choices for the destination:
  97. DF0:, DF1:, DF2:, and RAD:.  Clicking the popup gadget again or any other
  98. gadget will make the popup window go away, changing nothing.
  99.  
  100. The CONTROL area contains the buttons PREFS, START, QUIT, !, and the mode switch
  101.  
  102.  
  103. START
  104. -----
  105.  
  106. START will prompt you to insert a disk in the device you have selected.  MAKE
  107. SURE YOU DO THIS NOW. If you hit 'OK' and there is no disk present, DMS will go
  108. ahead and start writing and possibly damage your drive.  After inserting your
  109. disk and clicking 'OK', a console window will open and DMS will start
  110. decompressing the file. Depeneding on you preferences settings, the console
  111. window will either close right away or stay open, waiting for you to close it.
  112. If RAD: is your selected drive, then a requester will pop up and tell you to
  113. make sure you have mounted RAD: already. It will also mount RAD: for you when
  114. you click 'Mount'.  If you click 'OK' and RAD: is mounted, DMS will start
  115. decompressing the DMS file to RAD:. If RAD: is not mounted and you click 'OK'
  116. anyways, DMS will start writing to DF0:.  This is the way DMS works so make sure
  117. you either mount RAD: first or click 'Mount'. After clicking 'Mount', RAD: will
  118. be mounted and you will return to DMS-Face. Click start again and click 'OK' and
  119. away you go.
  120.  
  121. Every mode of DMS-Face has the following buttons:
  122.  
  123. PREFS
  124. -----
  125.  
  126. Clicking the PREFS button will take you to the preferences editor.  See the
  127. PREFERENCES section for information.
  128.  
  129. TOGGLE MODE
  130. -----------
  131.  
  132. This is the gadget that that looks just like a switch. Clicking on this switch
  133. will toggle between WRITE mode and READ mode, bringing up the proper interface.
  134. The '!' button above this switch will switch you to TEST/VIEW mode.
  135.  
  136. READ MODE
  137. ---------
  138.  
  139. The DESTINATION field works the same as WRITE mode's SOURCE field.  In READ
  140. mode, the DESTINATION field selects the path and filename you wish to compress
  141. the disk to. You use the popfile gadget to select the filename. If you select
  142. or type in a filename that exists already, a requester will ask you before
  143. overwriting it.  You may double-click on the name in the destination field
  144. to get more information on the file.
  145.  
  146. The TEXT FILE field lets you select and optional text file to compress with
  147. your new DMS file.  By default, the requester will look first in your S:
  148. directory or else it will look in the directory specified in the preferences
  149. editor under 'Text File Path'. You may double-click on the name in the text
  150. file field to get more information on the text file.
  151.  
  152. The LOW TRACK and HIGH TRACK slider gadgets correspond to the LOWTRACK and
  153. HIGHTRACK options of DMS. This allows you to split your disk into more than
  154. one DMS file.
  155.  
  156. The OPTIONS area corresponds to the available options for DMS in READ mode.
  157. Please read your DMS documentation for more information on these options.
  158. When the option is active, there will be a checkmark displayed next to it.
  159.  
  160. The SOURCE field displays the drive specified in the preferences files. This
  161. is where DMS will read from.
  162.  
  163. The CONTROL area contains the same buttons as write mode. Start will begin the
  164. DMS READ operation. This operation brings up the same requesters as the START
  165. button in WRITE mode.  See  WRITE mode for an explanation.  Clicking OK will
  166. open a console window and DMS will begin compressing right away from the defined
  167. LOWTRACK to the defined HIGHTRACK.
  168.  
  169. VIEW MODE
  170. ---------
  171.  
  172. The SOURCE filed contains the name of the DMS file to view.  If you have
  173. previously selected a filename in WRITE mode, that filename will be displayed
  174. here.  Manual entry or the popfile gadget can get a new filename to view.
  175.  
  176. The START button will begin the DMS VIEW operation right away.
  177.  
  178. TEST MODE
  179. ---------
  180.  
  181. TEST MODE works identically to VIEW MODE except the START button will begin
  182. the DMS TEST operation right away.
  183.  
  184. STATUS SECTION
  185. --------------
  186.  
  187. This is a simple window that gives you messages about what DMS-Face is doing.
  188.  
  189. PREFERENCES EDITOR
  190. ------------------
  191.  
  192. Here is where you define all of the variable needed by DMS-Face to operate
  193. properly on your system. You may only use the popfile gadgets here.  Manual
  194. text entry will have no effect except for in the Source/Dest drive field.
  195.  
  196. DMS COMMAND is where you tell DMS-Face what command to use for DMS.  The
  197. default is c:DMS but not everybody keeps DMS in their C: directory, so
  198. that may be changed here.  This should contain the path and filename of
  199. DMS.  Note that DMS v1.52 and up may not function properly at the moment.
  200.  
  201. DMS FILES DIRECTORY tells DMS-Face where to look first for your DMS files.
  202. The ASL file requester will open to this directory with the #?.DMS pattern.
  203. This is SYS: by default.
  204.  
  205. TEXT FILES directory tells DMS-Face where to look first for your text files
  206. to compress with a DMS archive in READ mode.  This is S: by default.
  207.  
  208. DEST/SOURCE drive is where you tell DMS-Face what device to use for WRITE
  209. and READ operations.  WARNING! If what you enter here is not a valid
  210. trackdisk device, like DF0:, DF1:, RAD:, the DMS will use DF0: by default,
  211. regardless if there is a disk in DF0: or not.  So, make sure you enter the
  212. name of a device that you have or that is active.  If you enter RAD:, make
  213. sure RAD: is mounted.  DMS-Face will give you the option to mount RAD: when
  214. you click START if RAD: is entered here.  In the future, there will be
  215. support for DMS v1.53 which allows you to use a hard disk location instead
  216. of just trackdisk devices.
  217.  
  218. CONSOLE AUTO/CLOSE section contains a row of switches labeled with the diff-
  219. erent DMS-Face operations.  These switches control whether the output console
  220. windows will close automatically or manually by the user.  The upright position
  221. (A) is for AutoClose, the down position (C) is for Close(manual).  By default,
  222. all windows AutoClose.
  223.  
  224. SAVE will save everything currently displayed in the text fields to
  225. S:DMSFACE.CFG.
  226.  
  227. USE will remember what was entered in the text fields but not save them to
  228. disk.  This is useful for temporarily changing some of your default paths
  229. and DEST/SOURCE drive.
  230.  
  231. CANCEL will exit preferences and return to the last remembered settings.
  232.  
  233. Clicking any of the above buttons will return you to the window you just left
  234. from when you clicked the preferences button.
  235.  
  236. Clicking the right mouse button will load the last saved preferences settings
  237. from disk.  If there are none on disk, then the internal defaults will be
  238. restored.
  239.  
  240. KNOWN PROBLEMS
  241. --------------
  242.  
  243. Clicking 'OK' from the START operation will launch DMS and it will start doing
  244. its thing even if there's no disk in the drive.  This is potentially dangerous
  245. but hitting CTRL-C in the output window will break the operation.  I am working
  246. on this but as it is, DMS has enough safeguards so there should be no problems.
  247. I won't take any responsibililty for any damaged incurred while using DMS-Face.
  248. If the program's instructions are followed, there will be no problems. I should
  249. have this problem eliminated in the next release.
  250.  
  251. The console window displayed at startup is not under my control.  Innovatronics
  252. has a new licensing policy for software written with CanDo.  I received a
  253. freely distributable version of DeckBrowser (which is bound into DMS-Face)
  254. which displays this message.  It's not too long and only displays upon
  255. startup.  Hopefully, they will take out the console window in a future version.
  256.  
  257. Bug reports can be sent to me via FidoNet at 1:260/158 (Pat Seguin).
  258.  
  259. DMS-Face is FREEWARE.  It may be distributed anywhere as long as the archive is
  260. left intact with all current files. No money can be made from its dist-
  261. ribution with the exception of copying fees for PD collections (i.e. Fred Fish)
  262.  
  263. CREDITS
  264. -------
  265.  
  266. Many thanks go to David Czaya for testing this for me and for all of his
  267. suggestions.  Without his help, this program may never have seen the light
  268. of day.
  269.  
  270. MagicWorkbench is by Martin Huttenloher.  Thanks Martin!
  271.  
  272. HISTORY
  273. -------
  274.  
  275. v1.0 (2/15/94)  First version released to public.
  276.  
  277. v1.1 (2/25/94)  Second version released to public.
  278.  
  279. Changes:
  280.  
  281. * Overhauled interface to blend better with MagicWB.  Used XHelvetica.font and
  282.   XEN.font where appropriate.
  283.  
  284. * Changed text button imagery (Start, Prefs, etc.) to use new XEN style and
  285.   XHelvetica font.
  286.  
  287. * Changed checkmark gadget imagery.
  288.  
  289. * Changed 'Switch' imagery.  Bigger and better, IMHO.
  290.  
  291. * Changed slider knob imagery in READ mode.  LowTrack and HighTrack text is now
  292.   displayed in white on dark grey in the XEN font.
  293.  
  294. * Changed drive popfile gadget to a popup gadget.  This now pops up a list of
  295.   drives you can choose from to use with DMS.  Most people will not have more
  296.   than 3 drives so I put in DF0:, DF1:, DF2:, and RAD:.  DMS won't let you
  297.   write to anything other than a trackdisk device so I saw no need to have a
  298.   file requester anymore.
  299.  
  300. * ALL string gadgets are gone now.  I did this because the string gadgets ONLY
  301.   use topaz.font and I wanted everything to be in 'XEN' fonts.  Everything is
  302.   achieved using mouse only now.  I think that's the way it should be.  If you
  303.   want to type, use DMS from CLI. ;)
  304.  
  305. * Added double-click function to all filename fields to give more information
  306.   to the user.
  307.  
  308.  
  309. ============================= Archive contents =============================
  310.  
  311. Original  Packed Ratio    Date     Time    Name
  312. -------- ------- ----- --------- --------  -------------
  313.     2273     559 75.4% 25-Feb-94 11:47:32  DMS-Face1.1.info
  314.      434     114 73.7% 11-Feb-94 23:21:24  DMS-Face1.1/ClickForColors
  315.     3135     416 86.7% 25-Feb-94 11:18:50  DMS-Face1.1/ClickForColors.info
  316.   262472  100843 61.5% 25-Feb-94 11:16:30  DMS-Face1.1/DMS-Face
  317.    12999    5220 59.8% 25-Feb-94 11:46:08  DMS-Face1.1/DMS-Face.doc
  318.     4666    1382 70.3% 25-Feb-94 11:18:50  DMS-Face1.1/DMS-Face.doc.info
  319.     4351    1368 68.5% 25-Feb-94 11:18:50  DMS-Face1.1/DMS-Face.info
  320. -------- ------- ----- --------- --------
  321.   290330  109902 62.1% 11-Apr-95 19:21:42   7 files
  322.